<!DOCTYPE HTML>
<html>
<head>
<meta charset="UTF-8" />
<link rel="stylesheet" href="../css/core.css"/>
<link rel="shortcut icon" href="../favicon.png" />
<title>指南 - Medoo中文文档</title>
<meta name="keywords" content="Medoo,Medoo 指南" />
<meta name="description" content="Medoo 指南" />
<script type="text/javascript" src="../js/qatrix-1.1.js"></script>
<script type="text/javascript" src="../js/prettify.js"></script>
<script type="text/javascript">
$ready(function ()
{
	prettyPrint();
	$className.add($('api_list_new'), 'on');
});
</script>
</head>
<body>
<header>
<div id="header_body" class="clearfix">
<a href="../index.html"><img width="297" height="58" id="head_logo" src="../images/medoo-logo.png" /></a>
<nav>
	<ul class="clearfix">
		<li><a href="../index.html">主页</a></li>
		<li><a href="../api/new.html">入门指南</a></li>
		<li><a href="../doc.html">开发文档</a></li>
		<li><a href="../about.html">关于</a></li>
	</ul>
</nav>
</div>
</header><div id="doc_container" class="clearfix">
<div id="api_list_wrap">
<h4>开始</h4 >
<ul class="api_list">
<li id="api_list_new"><a href="../api/new.html">new medoo()</a></li>
</ul>

<h4>Where 语法</h4 >
<ul class="api_list">
<li id="api_list_where"><a href="../api/where.html">where</a></li>
</ul>

<h4>查询</h4>
<ul class="api_list">
<li id="api_list_select"><a href="../api/select.html">select</a></li>
<li id="api_list_insert"><a href="../api/insert.html">insert</a></li>
<li id="api_list_update"><a href="../api/update.html">update</a></li>
<li id="api_list_delete"><a href="../api/delete.html">delete</a></li>
<li id="api_list_replace"><a href="../api/replace.html">replace</a></li>
<li id="api_list_get"><a href="../api/get.html">get</a></li>
<li id="api_list_has"><a href="../api/has.html">has</a></li>
<li id="api_list_count"><a href="../api/count.html">count</a></li>
<li id="api_list_max"><a href="../api/max.html">max</a></li>
<li id="api_list_min"><a href="../api/min.html">min</a></li>
<li id="api_list_avg"><a href="../api/avg.html">avg</a></li>
<li id="api_list_sum"><a href="../api/sum.html">sum</a></li>
</ul>

<h4>事务</h4 >
<ul class="api_list">
<li id="api_list_action"><a href="../api/action.html">action</a></li>
</ul>

<h4>高级</h4>
<ul class="api_list">
<li id="api_list_query"><a href="../api/query.html">query</a></li>
<li id="api_list_quote"><a href="../api/quote.html">quote</a></li>
</ul>

<h4>PDO 对象</h4>
<ul class="api_list">
<li id="api_list_pdo"><a href="../api/pdo.html">pdo</a></li>
</ul>

<h4>Debug</h4>
<ul class="api_list">
<li id="api_list_debug"><a href="../api/debug.html">debug</a></li>
<li id="api_list_error"><a href="../api/error.html">error</a></li>
<li id="api_list_log"><a href="../api/log.html">log</a></li>
<li id="api_list_last_query"><a href="../api/last_query.html">last_query</a></li>
</ul>

<h4>数据库信息</h4>
<ul class="api_list">
<li id="api_list_info"><a href="../api/info.html">info</a></li>
</ul>
</div>
	<div id="main_body">
		<div id="doc_version">版本: 1.1.3</div>
<h3>开始</h3>
<p class="intro">使用 Medoo 是非常容易的事!</p>

<h4>需求</h4>
<ul id="requirement_list">
	<li>PHP 5.1+, 推荐 PHP 5.4+， PDO 支持。</li>
	<li>已安装有 MySQL, MSSQL, SQLite 或其它的数据库。</li>
	<li>确保 php_pdo_xxx 已经安装并是启用状态。</li>
	<li>需要懂一些 SQL 知识。</li>
</ul>

<h4>小提示</h4>
<p class="intro">在 PHP 5.4+ 中, 你可以使用 <b>[]</b> 作为数组语法。所有的 Medoo 示例都使用 [] 代替 array()。</p>
<pre class="prettyprint linenums">
// 在 PHP 5.1 中
$data = array(&quot;foo&quot;, &quot;bar&quot;);

// 在 PHP 5.4+ 中
$data = [&quot;foo&quot;, &quot;bar&quot;];
</pre>

<h4>php_pdo 扩展列表</h4>
<ul id="requirement_list">
	<li>MySQL, MariaDB -> php_pdo_mysql</li>
	<li>MSSQL (Windows) -> php_pdo_sqlsrv</li>
	<li>MSSQL (Linux/UNIX) -> php_pdo_dblib</li>
	<li>Oracle -> php_pdo_oci</li>
	<li>SQLite -> php_pdo_sqlite</li>
	<li>PostgreSQL -> php_pdo_pgsql</li>
	<li>Sybase -> php_pdo_dblib</li>
</ul>

<h4>PHP PDO 驱动安装</h4>
<p class="intro">Medoo 需要 PHP 支持 PDO 。如果你之前没有安装，按照以下步骤安装：</p>
<pre class="prettyprint linenums">
// 打开 php.ini ，在想要安装的数据库扩展中去掉 &#039;;&#039; 。

// 安装之前
;extension=php_pdo_mysql.dll

// 安装之后
extension=php_pdo_mysql.dll

// 保存, 并重启 PHP 或 Apache 服务器。

// 如果 PDO 安装成功，你将在 phpinfo() 中看到 。
</pre>

<p class="intro">或可通过终端 (terminal) 安装。PDO_XXX 将会自动启用和配置。</p>
<code class="console-code">
$ sudo apt-get install php5-mysql
</code>

<h4>通过 Composer 安装</h4>
<p class="intro">如果你了解 composer，将非常容易安装和管理版本依赖。只需使用以下命令添加 Medoo 到 composer.json 中。或者你可以直接编辑它，这取决于你。</p>

<code class="console-code">
$ composer require catfan/Medoo
</code>

<p class="intro">更新 composer</p>

<code class="console-code">
$ composer update
</code>

<h4>通过下载安装</h4>
<p class="intro">这是最简单的方式。只需下载 medoo.php 并放到合适的目录中，然后 require，之后就可以开始使用了!</p>
<pre class="prettyprint linenums">
require  &#039;medoo.php&#039;;
</pre>

<h4>配置</h4>
<p class="intro">有三种方式来配置 medoo 和启动一个数据库连接。</p>
<pre class="prettyprint linenums">
// 如果你通过 composer 安装, 只需在项目的开始部分加上此代码即可自动加载。
require &#039;vendor/autoload.php&#039;;

// 或者你是下载 medoo.php 并放置到项目目录中，require 即可。
require  &#039;medoo.php&#039;;

$database = new medoo([
	// 必须的
	&#039;database_type&#039; =&gt; &#039;mysql&#039;,
	&#039;database_name&#039; =&gt; &#039;name&#039;,
	&#039;server&#039; =&gt; &#039;localhost&#039;,
	&#039;username&#039; =&gt; &#039;your_username&#039;,
	&#039;password&#039; =&gt; &#039;your_password&#039;,
	&#039;charset&#039; =&gt; &#039;utf8&#039;,

	// [可选]
	&#039;port&#039; =&gt; 3306,

	// [可选] 表名前缀
	&#039;prefix&#039; =&gt; &#039;PREFIX_&#039;,

	// [可选] 连接的驱动选项，请阅读 http://www.php.net/manual/en/pdo.setattribute.php
	&#039;option&#039; =&gt; [
		PDO::ATTR_CASE =&gt; PDO::CASE_NATURAL
	]
]);

$database-&gt;insert(&quot;account&quot;, [
	&quot;user_name&quot; =&gt; &quot;foo&quot;,
	&quot;email&quot; =&gt; &quot;foo@bar.com&quot;
]);
</pre>

<h4>For MSSQL</h4>
<div class="note">如果你要在 PHP 中使用 Medoo 连接 MSSQL，需要安装 PHP 扩展，Windows 中为 <b>pdo_sqlsrv</b> ，Linux/UNIX 中为 <b>pdo_dblib</b> 。PHP 已经弃用 pdo_mssql 扩展了，并准备移除。</div>

<h4>For SQLite</h4>
<pre class="prettyprint linenums">
$database = new medoo([
	&#039;database_type&#039; =&gt; &#039;sqlite&#039;,
	&#039;database_file&#039; =&gt; &#039;my/database/path/database.db&#039;
]);

$database-&gt;insert(&quot;account&quot;, [
	&quot;user_name&quot; =&gt; &quot;foo&quot;,
	&quot;email&quot; =&gt; &quot;foo@bar.com&quot;
]);
</pre>

		</div>
	</div>

<footer>
<div id="footer_body" class="clearfix">
<a id="github_link" href="https://github.com/catfan/Medoo">
<div id="github_text">Fork me on GitHub</div>
</a><p id="footer_text">The Medoo project, All Rights Reserved, 2017.</p>
</div>
</footer></body>
</html>